#!/usr/bin/env python3
# -*- coding:utf-8 -*-

# ---------------------------------------------------------------------------------------------------
# 文件读
'''
读写文件是最常见的IO操作。Python内置了读写文件的函数，用法和C是兼容的。
读写文件前，我们先必须了解一下，在磁盘上读写文件的功能都是由操作系统提供的，
现代操作系统不允许普通的程序直接操作磁盘，
所以，读写文件就是请求操作系统打开一个文件对象（通常称为文件描述符），
然后，通过操作系统提供的接口从这个文件对象中读取数据（读文件），
或者把数据写入这个文件对象（写文件）。
'''
import os
s = os.sep      #根据系统自动返回文件路径的分隔符 linux'/'  Windows'\'
fpath = 'E:' + s + 'Codes' + s + 'PythonProject' + s + 'life-is-short' + s + 'FileIO' + s + 'test.txt'

#1.open
f = open(fpath, 'r')
#2.read
print(f.read())
#3.close
f.close()
"""
由于文件读写时都有可能产生IOError，一旦出错，后面的f.close()就不会调用。
所以，为了保证无论是否出错都能正确地关闭文件，我们可以使用try ... finally来实现：
"""
try:
    f = open(fpath, 'r')
    print(f.read())
finally:
    if f:
        f.close()
#但是每次都这么写实在太繁琐，所以，Python引入了with语句来自动帮我们调用close()方法：
with open(fpath, 'r') as f:
    print(f.read())
"""
这和前面的try ... finally是一样的，但是代码更佳简洁，并且不必调用f.close()方法。

调用read()会一次性读取文件的全部内容，如果文件有10G，内存就爆了，
所以，要保险起见，可以反复调用read(size)方法，每次最多读取size个字节的内容。
另外，调用readline()可以每次读取一行内容，调用readlines()一次读取所有内容并按行返回list。
因此，要根据需要决定怎么调用。

如果文件很小，read()一次性读取最方便；如果不能确定文件大小，反复调用read(size)比较保险；如果是配置文件，调用readlines()最方便：
"""
f = open(fpath, 'r')
for line in f.readlines():
    print(line.strip()) # 把末尾的'\n'删掉
f.close()
# ---------------------------------------------------------------------------------------------------
# file-like Object
"""
像open()函数返回的这种有个read()方法的对象，在Python中统称为file-like Object。
除了file外，还可以是内存的字节流，网络流，自定义流等等。
file-like Object不要求从特定类继承，只要写个read()方法就行。

StringIO就是在内存中创建的file-like Object，常用作临时缓冲。
"""


# ---------------------------------------------------------------------------------------------------
# 二进制文件
"""
前面讲的默认都是读取文本文件，并且是UTF-8编码的文本文件。
要读取二进制文件，比如图片、视频等等，用'rb'模式打开文件即可：。
"""
#fpath = 'E:' + s + 'Codes' + s + 'Git' + s + 'life-is-short' + s + 'test.jpg'
with open(fpath, 'rb') as f:
    print(f.read())


# ---------------------------------------------------------------------------------------------------
# 字符编码
"""
前面讲的默认都是读取文本文件，并且是UTF-8编码的文本文件。
要读取非UTF-8编码的文本文件，需要给open()函数传入encoding参数，例如，读取GBK编码的文件：
"""
fgbk = 'E:' + s + 'Codes' + s + 'PythonProject' + s + 'life-is-short' + s + 'FileIO' + s +'gbk.txt'
with open(fgbk, 'r', encoding='gbk') as f:
    print(f.read())

"""
遇到有些编码不规范的文件，你可能会遇到UnicodeDecodeError，因为在文本文件中可能夹杂了一些非法编码的字符。
遇到这种情况，open()函数还接收一个errors参数，表示如果遇到编码错误后如何处理。最简单的方式是直接忽略：
"""
with open(fgbk, 'r', encoding='gbk', errors='ignore') as f:
    print(f.read())

# ---------------------------------------------------------------------------------------------------
# 写文件
"""
写文件和读文件是一样的，唯一区别是调用open()函数时，传入标识符'w'或者'wb'表示写文本文件或写二进制文件：
"""
#1.open
f = open(fpath, 'wb')       #写的时候对应b''
#2.write
n = f.write(b'W:Hello, python!')    #b''只能写入ASCII码
print(n)        #write了n个字符
#3.close
f.close()
#再读出来验证下
with open(fpath, 'r') as f:
    print(f.read())
    
"""
你可以反复调用write()来写入文件，但是务必要调用f.close()来关闭文件。
当我们写文件时，操作系统往往不会立刻把数据写入磁盘，而是放到内存缓存起来，空闲的时候再慢慢写入。
只有调用close()方法时，操作系统才保证把没有写入的数据全部写入磁盘。
忘记调用close()的后果是数据可能只写了一部分到磁盘，剩下的丢失了。所以，还是用with语句来得保险：
"""
with open(fpath, 'w') as f:
    f.write('W:Hello, World!')

"""
小结

在Python中，文件读写是通过open()函数打开的文件对象完成的。使用with语句操作文件IO是个好习惯。
"""









